home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr37 / reqst10.zip / REQUEST.DOC < prev    next >
Text File  |  1995-03-06  |  17KB  |  348 lines
  1.  
  2. Request! v1.0ß wcCODE 4.01 - A NetMail FTP File Request Processor for WC!
  3.  
  4.  
  5. This wcx file will process File Requests from a user on ANY NET that you have
  6. set up in your FTSC Mailer, including the Internet using Fido<>Gateway.
  7. The Processor will reply to File Requests and automatically UUEncode the
  8. file back to the User in an outbound Netmail Message.  This is NOT a file
  9. attachment but a FTP method to send a file using a Email Message.  The
  10. program reads a "MAGIC" name list and responds automatically using the NETMAIL
  11. Conference of Wildcat!  Request! can process a message formatted to SEND HELP,
  12. or SEND LIST, or SEND FILE <magicName>.  The Files are automatically UUEncoded
  13. to fit a 150 line Message format used by Wildcat's Netmail Conference.
  14. Freeware  (C) 1995 Maddog Productions
  15.  
  16. This program ONLY uses the Netmail Conference of Wildcat! and will scan
  17. that conference. I dont know if this program will work properly for those
  18. Sysop's who have their OWN Internet Email address/routing account and their
  19. own Internet Email conferences.      This utility was written basically for
  20. those Sysops using a FTSC Mailer to store/forward Netmail.
  21.  
  22.  
  23. Warning!  This program is a POWERFUL Wildcat! utility.  It uses the Message
  24. and Conference Database of the Wildcat! system. Please read the documentation
  25. thoroughly before proceeding.
  26.  
  27.  
  28. Minimum SYSTEM Requirements:
  29.  
  30. A Working NetMail Conference in your Wildcat! System.
  31. A Working TOSSER and Front End Mailer to process/recieve Netmail.
  32. Example:  WildMail or InterEcho as a Tosser,  FrontDoor, BinkleyTerm, or
  33.           InterMail as a Mailer....etc.
  34. (NOTE!:  I have NOT tested this program using a QWK Net. It may work provided
  35.  a QWK net can be configured for a NetMail conference, Request! Uses Fido
  36.  style addressing when replying a message back.)
  37.  
  38.  
  39.  
  40. How does REQUEST! work?
  41.  
  42. Wouldn't it be great to make some files available to users on a Network?
  43. On fidonet?  On other FTSC Nets?  On the Internet?  ........ Background.
  44. FREQ'ng is a feature that only SYSOPs can enjoy and involves actual polling
  45. and retrieving the archived file.  It is not practical to do this for users
  46. because of the cost involved.
  47.  
  48. Now with REQUEST!, this changes the way a file is requested and sent.
  49. It changes the File into a Message and transmits the Message thru normal
  50. Routing of your Mailer.  The process adapted and used mostly by the Internet
  51. is called FTP or UUEncoding.  The UUEncoded message encrypts a file (.exe,
  52. .ZIP or any file ext) into the letters A-Z (All caps, and the number 1-0 and
  53. the Shifted !-). We send Pure Messages.   REQUEST! simply processes a user
  54. request coming in the form of a NETMAIL message and replies in a Message
  55. Format only with the Requested file UUEncoded.  Request! handles all the
  56. file requesting for you.  Request! simply runs in your Nightly Maintenance
  57. and starts scanning your NetMail file for a request. If it finds one,
  58.  
  59.                                                      REQUEST! Documentation       
  60.                                                                 Page 2
  61.  
  62. it processes it otherwise does nothing.
  63.  
  64.  
  65. I am jumping the gun a bit here, but for those that understand FTP,
  66. you may get the idea of REQUEST! when reading this.   REQUEST! is all
  67. Message activated by the User:
  68.  
  69. The Format for the Message the User would use is simple.
  70. They enter a NetMail message to your system:
  71. On the TO:  Line, they put the  Fictitious Name you are gonna assign below:
  72. (Example, I used MADDOG PRODS)
  73. On the SUBJECT line, a series of KEY WORDS are used:
  74.  
  75. TO:  MADDOG PRODS       (1:2614/716)
  76. FROM: Your NAME         (1:999/999)
  77. SUBJECT:    SEND HELP
  78. -------------------------------
  79. Would send The HELP.TXT file in a NetMail message.  This HELP file
  80. just explains what I am explain right here. Format of message & stuff.
  81.  
  82. SUBJECT:   SEND LIST
  83. -------------------------------
  84. Would send the LIST.TXT file in a Netmail Message which informs them
  85. what files you have available for file request.
  86.  
  87.  
  88. SUBJECT:   SEND FILE MagicName
  89. -------------------------------
  90. Would send the File directed by MAGIC.TXT Uuencoded back to them
  91. in a Message format.  (It may be multiple parts UUEncoded depending
  92. upon how big the FILE is).
  93.  
  94. I recommend you use my HELP.TXT, LIST.TXT as a format and just HACK
  95. the crap out of em until it reads what you want to tell the user. <g>
  96.  
  97. =====================================================================
  98. Setup  (Quick and Dirty)
  99.  
  100. 1.  Log in Locally as Sysop.  Go to the Sysop Menu and Look up your SySop
  101.     record.   Please write down the Sysop USER ID Number located at the
  102.     top RIGHT ---> side of the screen.
  103.  
  104. 2.  Next, From the Same User area of the Sysop Menu, (A)dd a User.  PICK a
  105.     fictictious Name that you want your Email and Requests coming too.
  106.     Usually your BBS name could work.  Try to make it 2 Words!  Mine is:
  107.     Maddog Prods   as First  Last.     When you add this record, Write
  108.     down the USER ID Number at the TOP RIGHT ---> side of the screen.
  109.     Give this fictictious Name enough information so that no one can use the
  110.     account but you.
  111.  
  112. 3.  Next, Make a Directory under your Wildcat! Home directory called REQUEST.
  113.     Ex:  MD \WILDCAT\REQUEST      or   MD \WC40\REQUEST  as an example.
  114.     Unzip all the contents of this archive in this directory.
  115.  
  116. 4.  Edit the REQUEST.CFG file.   A note about the .CFG file!  EVERY ITEM
  117.     MUST be assigned a value for you to process proper mail. Failing to do
  118.  
  119.                                                      REQUEST! Documentation       
  120.                                                                 Page 3
  121.  
  122.     will cause trouble.  PLEASE! PUT CAPS LOCK KEY ON. THE ENTIRE CONFIG
  123.     FILE SHOULD BE MADE IN CAPITAL LETTERS.
  124.  
  125.     NETCONF=number      Enter the Number of the NETMAIL Conference assigned.
  126.                         Ex:  NETCONF=8  if 8 was your NetMail Conference.
  127.  
  128.     USENAME=Fictitous Name   (First Last)
  129.                         EX:  The Name you created in Step 2 above. PUT a SPACE
  130.                              between FIRST and LAST Name. USENAME=MADDOG PRODS
  131.  
  132.     USEID=number        Enter the Number you wrote down for the NEW Ficticious
  133.                         name.
  134.                         Ex:  USEID=782
  135.  
  136.     SYSOPID=number      Enter the NUMBER you wrote down for your SYSOP Name
  137.                         above.  EX:   SYSOPID=1
  138.  
  139.     PVTCONF=number      Enter the NUMBER of your PRIVATE EMAIL CONFERENCE.
  140.                         This is for Sysop notification of errors and stuff.
  141.                         It should be a PRIVATE only local Mail conference.
  142.                         EX:  PVTCONF=0
  143.  
  144.    (SAVE THIS FILE and Continue.)   Saved...... REQUEST.CFG
  145.  
  146. 5.  EDIT or CREATE a file called:    MAGIC.TXT  (in the REQUEST HOME DIR)
  147.     This file uses the following format.
  148.     MagicName,d:\path\filename     1 per line
  149.  
  150.     Where:  MagicName is a Name consisting of no more than 8 characters
  151.             and identifies what program File Request will be sent.
  152.     followed by a comma,
  153.     Then followed by a Complete Drive:\Path\Filename that the Magic Name
  154.     is assigned too.  Example:
  155.  
  156.     OFFHOOK,D:\FILES\OFFHK30.ZIP
  157.     ROMON,D:\FILES\ROMON10.ZIP
  158.     ...
  159.     ETC.
  160.     (NOTE!  Try to limit your MAGICNAME to 8 characters, AVOID using
  161.      Numbers at the END of the MagicName because of the UUEncode splitting)
  162.  
  163.  
  164.     This list would contain all the files you wish to make available
  165.     for FILE Request.  REQUEST! Reads this list based on the USER
  166.     input of the SUBJECT line of the NETMAIL MESSAGE.  The MAGIC NAMES
  167.     you pick here should be specified in the LIST.TXT file explained below.
  168.  
  169.  
  170.  
  171. 6.  EDIT The SAMPLE HELP.TXT file in this new Request directory.
  172.     This HELP.TXT file is sent to a user if they place SEND HELP as the
  173.     subject to your fictious Name account.  This HELP file can consist
  174.     of anything you wish. It should include your Email/Netmail addresses
  175.     including the INTERNET<>FIDONET gateway address format as follows:
  176.  
  177.     first.last@fnode.nNet.zZone.fidonet.org
  178.  
  179.                                                      REQUEST! Documentation       
  180.                                                                 Page 4
  181.  
  182.     Example of mine is  Fido 1:2614/716
  183.                         so my Internet<>FidoGateway is
  184.                         maddog.prods@f716.n2614.z1.fidonet.org
  185.  
  186.    Notice the use of my Fictitious name and note the use of my Fidonet
  187.    address as my Internet address above.
  188.  
  189.    So, People who want to FTP File request from the Internet using my Wildcat!
  190.    Netmail conference can do so using this long address on their end. As
  191.    long as my tosser forwards it into my WILDCAT! conference with a Return
  192.    address (from the Internet<>Fidonet Gateway) they will get a reply.
  193.  
  194.    Request! will send a file request back from the FTSC Mailer thru normal
  195.    routing channels unless specified differently in your ROUTE.xx file of your
  196.    mailer.  Please note:  Request! sends a UUEncoded FILE, not a file
  197.    attachment.  The user at the other end, just receives this encrypted ASCII
  198.    Text Message that is known as UUEncoded. They user UUDecode to put the
  199.    ASCII text back into the file's original format.  You should make available
  200.    the UUENCODED programs available for Download on your BBS.
  201.  
  202. 7. EDIT the LIST.TXT file.  This is similar to the HELP.TXT file and is sent
  203.    when the user puts SEND LIST as the SUBJECT in the Netmail message.
  204.    The LIST.TXT file contains all the Files that are available for FILE
  205.    Requests from your SITE. It should contain a FTP "MAGIC" Name followed
  206.    by the Description of what the program does.  SEE 5 above.
  207.  
  208. 8. UNZIP the UUEXE525.ZIP file.  This is a FREEWARE program I found on a
  209.    CDRom and it is a Really good UUEncoder written by Richard Marks here
  210.    in PA.   You can use any UUEncoded provided it allows the use of a
  211.    -S line field.   Because of the Wildcat! message Database only permits
  212.    150 lines, Request! forces a UUENCODE SHELL with a -S 145 command line.
  213.    It is recommended that you use the UUEncoded included, and make it
  214.    available for Download on your BBS.  The UUENCODE.EXE and UUDECODE.EXE
  215.    MUST BE PLACED in a Directory that is IN YOUR PATH.
  216.  
  217.  
  218. 9. That is about it. You just need to add the following lines in your
  219.    Nightly Maintenance BATCH FILE just prior to running Wildmail or your
  220.    tosser and prior to running wcPACK.
  221.  
  222.    C:
  223.    CD \WILDCAT     (or your Wildcat Home Directory)
  224.    WILDCAT /R C:\WILDCAT\REQUEST\REQUEST.WCX    (sub correct paths)
  225.    CD \WM40
  226.    WM SCAN NETMAIL           (run your TOSSER!)
  227.    wcPACK (num)     (Pack your NetMail Conference)
  228.  
  229. That covers it!
  230.   After you make up your Magic Name list, Test it.  Create a NetMail
  231.   message locally from yourself to your Fictitious Name and try
  232.   it!  If you use SEND FILE <filename> It should UUEncode that file
  233.   back to you in a Netmail message.  ALso try SEND HELP and SEND LIST
  234.   on the command lines.
  235.  
  236.   PROBLEMS!!!!  (READ THIS!!! It is important!)
  237.  
  238.  
  239.                                                      REQUEST! Documentation       
  240.                                                                 Page 5
  241.  
  242.   I KNOW of 1 KNOWN problem, and quite frankly, I dont know how to get
  243.   around it.  The WCX file starts scanning the NetMail Conference at
  244.   Message Number 1.  SO, If you don't have a MESSAGE number 1, it skips the
  245.   entire process.   Moral of the story?   Make sure you have a MESSAGE 1
  246.   in the NetMail conference. What I did, Was create a dummy Message in
  247.   the NetMail conference at spot 1 and I didnt delete it (or after my
  248.   WildMail flagged it for deletion, I went back in an UN-flagged it).
  249.   So I have a Message Number 1 at all times.  If anyone knows a fix for
  250.   this, besides re-numbering the conferences all the time....Send em
  251.   my way.
  252.  
  253.   ALSO, This is a BETA, So you can expect some problems! This program
  254.   interacts with the Wildcat Message Database, so if you experience a
  255.   problem, crash, corruption...anything, please email me and let me
  256.   know. I have NOT found any of these on my system, but thought I would
  257.   mention the possibility exists on any software product. <g>
  258.  
  259.  
  260.  
  261.    REGISTRATION?   (NOT!)
  262.  
  263.  
  264.    This program is hereby released as Public Domain software known as
  265.    "FREEWARE"!   It may be freely distributed and used as long as this
  266.    document and the program remain unaltered, and you do NOT charge a
  267.    fee for it use! (a duplication fee for many shareware houses is
  268.    acceptable as long as the price remains under $3.00)  The author, William
  269.    Mantz, does NOT warrant, guarantee, or make any representations as
  270.    to the performance or reliability of this software and will not be held
  271.    responsible for any incedental or consequential damage that may incur.
  272.    Under no circumstances shall the author be held liable for damages
  273.    occurred by lost income or lost sales whatsoever, nor does the author
  274.    assume responsibility for damages to equipment as a result of the use
  275.    of this program.  Quite simply, You are using it at your own risk.
  276.    This software is offered "AS IS".
  277.  
  278.    THE SOURCE CODE
  279.  
  280.    Sorry, the Source Code for this program is unavailable.  I have spent long
  281.    hours working out the details to send escape codes sequences to the
  282.    laserjet printer and to provide a high quality, small, yet powerful
  283.    printing utility.  The decision not to share the source code gives me
  284.    the ability to safeguard the reliability and integrity of the program.
  285.  
  286.  
  287. ****  SUPPORT??? call Maddog Productions BBS!  (a Wildcat! BBS)
  288.  
  289.    You can get the latest copy of this program from my own BBS!
  290.    Maddog Productions is proud to present a CD-ROM + Hard Disk database.
  291.    It is also a Support BBS for GuareGraphics which contains many fine
  292.    programs written from a very good friend of mine Jim Guare!
  293.    You can download any of those files without prior validation.
  294.  
  295.    Here is the number!
  296.  
  297.    (215) 855-4621   2400 bps to 28.8k bps USRobotics DS Courier
  298.  
  299.                                                      REQUEST! Documentation       
  300.                                                                 Page 6
  301.  
  302.  
  303.    You can also reach me thru NETMAIL on FIDONET!
  304.    I have just recently joined this fine public network.
  305.  
  306.    William Mantz
  307.    Fido: 1:2614/716
  308.  
  309.    Enjoy!
  310.  
  311. ***   Wildcat! is a registered Trade Mark of Mustang Software Inc.
  312.       FidoNet and Fido are both registered to Tom Jennings and Fido Software.
  313.       Other Trademarks unkownly mentioned in this documentation are registered
  314.       to their prospective authors.
  315.       Internet?  Probably belongs to all of us at one point in time.
  316.  
  317. ---Tag for the day
  318. XT USERS!  It's time to Upgrade!  Same for you 2400 baud Modem people!
  319.  
  320.  
  321.  
  322. Comments welcome at:
  323.  
  324. Another fine program from...
  325. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  326. ░                                                                     ░
  327. ░  +++++++++++++++++   Maddog  Productions  BBS  +++++++++++++++++++  ░█
  328. ░    24 Hours               A Wildcat! BBS         Over 80,000 Files  ░█
  329. ░ Latest Software         (215) 855-4621  Node 1   using a CD-ROM     ░█
  330. ░ Lansdale, PA            (215) 855-1028  Node 2   Rotation System    ░█
  331. ░                    2400 to 28.8k USRobotics HST  and 440 Meg HD!    ░█
  332. ░                    2400 to 14.4k USRobotics Sportster               ░█
  333. ░                     for IBM Compatible Computers                    ░█
  334. ░                                                                     ░█
  335. ░      FidoNet 1:2614/716        ▀▄▀▄ RaceNet/United Net 7223:2200/1  ░█
  336. ░   Race Fans! Check us OUT!     ▀▄▀▄   NASCAR & Motor Sports NET!    ░█
  337. ░                                                                     ░█
  338. ░        Internet: william.mantz@f716.n2614.z1.fidonet.org            ░█
  339. ░  Programming, Utilities, Database, Publishing, Hobby, Games, Gifs   ░█
  340. ░ C Programs, BASIC, Fortran, PASCAL, Assembler, UNIX, ADA Libraries  ░█
  341. ░      Large BRE Netted Game in USA!  TradeWars and L.O.R.D. Reg.     ░█
  342. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░█
  343.  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  344. "Home of the CDROM Rotation System!" - Rotating popular shareware discs!
  345.  
  346.  
  347.  
  348.